home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
User's Choice Windows CD
/
User's Choice Windows CD (CMS Software)(1993).iso
/
windows4
/
qfind15.zip
/
QFIND.DOC
< prev
next >
Wrap
Text File
|
1992-03-28
|
22KB
|
709 lines
Qfind
VERSION 1.5 - 3/28/92
Qfind Copyright 1991,1992 by JebSoft and James E. Bell
135 Gunlock Trace
Roswell, Georgia 30076
Electronic Mail on Compuserve: 70270,534
Qfind Version 1.5 - Page 1
QFIND (Quick Find) is a set of utility programs that perform
the function of finding the location of a file or files on
your system. QFIND uses a different approach than most of
the file-finding programs available today.
FEATURES:
* Extremely fast file name search.
* Very easy to use.
* Command line version of search program.
* Microsoft Windows 3.0 version of search program.
Files included in QFND15.ZIP include:
QFBUILD.EXE Builds file for searching from selected
disks.
QFIND.EXE File finder utility - Command line
version.
QFINDWIN.EXE File finder utility - Windows version.
THREE_D.DLL DLL file used in Qfindwin. This file
should be located in your Windows
directory.
QFINDWIN.INI Initialization file for QFINDWIN. This
file must be located in you Windows
directory.
QFIND.DOC This file
QFIND.HST History of changes for Qfind.
REGISTER.FRM Registration form.
Qfind Version 1.5 - Page 2
Qfind, like many DOS utilities, was born of necessity. I
needed to find "that file". I did not know which directory
contained the file, much less which disk contained the file.
I got out one of the existing file find utilities and used
it to search all my drives for "that file". After much disk
activity, I found the file. I needed to find another file
later and did the same thing. Most of my files (99.99%) had
not changed their location on my system between searches.
Why do all that disk activity each time I need to find a
file when most of the files are still in the same location
since the last time? Why not "remember" where all the files
are located and use that data for later searches. If the
file system has changed considerably since the last search,
just build the file database again and use the new one to
search.
Qfind is a file finding system that does just that. Qfbuild
builds a data file that contains all files on all selected
drives on your system. The search programs (Qfind and
Qfindwin) then use that file to do their searches. This
results in extremely fast search times since the actual file
names in the disk directories are not read again. On one of
my machines that has 6 32 meg logical drives and 5000+
files, the search time is less than 3 seconds. On another
machines that has 2 32 meg logical drives, 8 network drives
and over 15,000 files, the search time is less than 5
seconds.
************************************************************
Installation:
All the files, except THREE_D.DLL and QFINDWIN.INI can be
located in any directory of your choice. QFINDWIN.INI must
be in the same directory as WIN.INI. THREE_D.DLL can be in
any directory specified in the path statement. The
recommended place is in the WINDOWS directory.
************************************************************
QFBUILD.EXE
Qfbuild is the program that builds the database that
contains all the file names and directory names on selected
Qfind Version 1.5 - Page 3
drives along with the optional switches for including Arc
and Zip files. . It is executed from the command line with
the following syntax....
QFBUILD [-z] [-a] first_drive next_drive next_drive
etc....
The Arc and Zip switches must precede the drive letters.
The "[ ]" are not included on the actual command line. They
are here to show that these parameters are optional.
If the -z switch is included, all ZIP files on the selected
drives will be searched to include their files names in
Qfind.dat. The -a switch is for ARC files.
Examples:
QFBUILD -a c d e f g
This would build a Qfind.dat containing all files in
drives c, d, e, f, g and the internal directories of any
ARC files found on these drives.
QFBUILD -z e f g
This would build a Qfind.dat containing all files in
drives e, f, g and the internal directories of any ZIP
files found on these drives.
QFBUILD -a -z c: d: e: f: g:
This would build a Qfind.dat containing all files in
drives c, d, e, f, g and the internal directories of any
ARC and ZIP files found on these drives.
Qfbuild will take drive letters with or without the trailing
":" after the drive letter. The data file is built in the
order of the drives on the command line. If you need to
alter the order for some reason, just order the drives on
the command line as you wish.
Qfbuild sorts the file names in each subdirectory in
ascending order. This was done to make it easier to
visually read the output in Qfind or Qfindwin.
The inclusion of the -z and -a switch is recommended.
Qfind.dat would then contain all files on the selected disks
including the files contained in the ARC and ZIP files.
Qfind Version 1.5 - Page 4
The only reason for leaving out the -z and -a switch on the
command line would be to make Qfind.dat smaller. Qfind and
QfindWin both have the ability to search for files either
including or excluding ARC and ZIP files.
Changing the location of the data file....
Normally, the data file is written to the root directory
of the C drive. If you need to change the location, add
the variable QFIND to the environment. The variable QFIND
is set to the drive and directory where you want the data
file to be located. Example....
Set QFIND=E:\QFIND
QFBUILD will write the data file in the QFIND directory
on the E drive and QFIND will look there to find the
file.
***********************************************************
QFIND.EXE
Qfind is the command line version of the search program. It
is executed with the very simple syntax as follows....
QFIND [-x] [-g] search_mask
Example:
Qfind *.c
The above command will find all the .C files on all selected
drives and list them to the screen. I did not allow for
multiple search masks because the search is so fast and the
actual directory structure is not re-read for each search.
If you need to find files with another search mask, just re-
execute Qfind with the new search mask.
The -x switch must precede the search mask parameter, and is
used to exclude the search of the contents of any ARC or ZIP
files. If the -x switch is added to the command line, Qfind
will NOT search the contents of ARC or ZIP files.
If QFBUILD was not created with the contents of ARC or ZIP
files selected, then Qfind cannot access the names in those
files. Therefore the -x switch would have no effect.
Qfind Version 1.5 - Page 5
The -g switch is added to provide a "GOTO" function to
Qfind. If the -g switch is selected, it will change the
current drive and the current directory to the drive and
directory containing the matched file name.
Example:
QFind -g xyz.exe
The current drive and current directory will be changed to
the drive and directory that contains the FIRST occurrence
of XYZ.EXE. If there are multiple copies of XYZ.EXE on your
system QFind selects the first one matched in the data file
built by QFBUILD. In this example, Qfind would also search
the contents of any ZIP or ARC files since the -x parameter
is omitted. If a file match were found in a ZIP file, Qfind
would change the drive and directory to the drive and
directory containing the ZIP file. If you don't want to
match names in the ZIP or ARC files, just place the -x
switch along with the -g switch on the command line like
so....
Qfind -x -g xyz.exe
The search mask conforms to the standard DOS wildcard naming
convention.
Examples:
QFIND ???e???.* Will find all files with an "E" in the
4th character of the file name.
QFIND *.?X? Will find all files with an "X" in the
2nd character of the file type.
QFIND ?abc*.exe Will find all .EXE files with "ABC" in
the 2nd through the 4th position.
QFIND looks for the data file in the root directory of the C
drive unless the environment variable QFIND is set. See
QFBUILD for example.
************************************************************
QFINDWIN.EXE
Qfind Version 1.5 - Page 6
This is the Microsoft Windows 3.0 version of the search
program. It uses the same search mask conventions as QFIND.
To use QFINDWIN, execute it from Windows with either the
program manager or the file manager. It will display a
screen with "FIND" on the menu. Click on FIND and a drop
down menu will appear. It has the following items:
Find This selection will display a dialog box asking
for the search mask.
About This selection will display the "About" dialog
box.
Exit This selection will exit the program.
To search for files......
Click on Find and enter the search mask in the text box.
click on OK and the matched file names will appear in the
main box. If there are more matches than will fit in the
window, vertical scroll bars will appear. You can use
these vertical scroll bars to move the text around.
You can use the following scroll bar items.....
Scroll UP (UP arrow) - Each click will scroll the file
names UP one line.
Scroll DOWN (DOWN arrow) Each click will scroll the file
names DOWN one line
Scroll Page UP - Each click will scroll the file
UP one page.
Scroll Page DOWN - Each click will scroll the file
DOWN one page.
Move with Thumb - You can move the display of
file names back and forth with
the thumb control. The thumb
control is the little square
box in the vertical scroll bar.
If you move the thumb to the
half-way location, the display
Qfind Version 1.5 - Page 7
of file names will move down to
the middle, etc.
A checkbox for including ARC and ZIP files has been added to
QFindWin. Click on the checkbox to toggle the ARC and ZIP
file setting. If an "X" appears in the checkbox, QfindWin
will search for file name matches within ARC and ZIP files.
If the color option is not selected, the text is shown as
follows. DIRECTORY names are shown in bold font. FILE names
are shown in normal font. File names that are found within
ARC or ZIP files are shown in italic type with the ARC or
ZIP name shown surrounded by "**".
If the color options is selected the text is shown as
follows. Directory names as shown in the Directory color
selection in QFINDWIN.INI. File names are shown in the File
color selection in QFINDWIN.INI. File name that are found
within ARC or ZIP files are shown in the ZIP color selection
in QFINDWIN.INI with the ARC or ZIP name shown surrounded by
"**".
QFINDWIN.INI
A new file (QFINDWIN.INI) has been added in this version.
All parameters for QFINDWIN are now located in this file.
QFINDWIN no longer looks in WIN.INI for anything.
QFINDWIN.INI must be located in the same directory as
WIN.INI.
There are 2 different sets of parameters contained in
QFINDWIN.INI. The file parameter is explained in the next
section. The new COLOR parameters allow you to choose the
color option for display and to choose the colors that are
displayed.
The COLOR parameter can have either of 2 values.
Color=NO will select the bolding, and italic fonts for
display in black.
Color=YES will select colors for display.
If the color option is selected, there are 3 parameters that
you can set to select the colors for each file type.
The DIRECTORYCOLOR entry selects the color to display
directory names.
The FILECOLOR entry selects the color to display file names.
Qfind Version 1.5 - Page 8
The ZIPCOLOR entry selects the color to display ZIP and ARC
file names.
The format of these entries are as follows.
Each entry contains 3 values, separated by commas. These
are the intensity values of the Red, Green, and Blue colors
in a range of 0 to 255. 0 is no intensity and 255 is max
intensity. The values are in the order of RED, GREEN, BLUE.
You can set these values to any combination you want to
select different colors. If you entry a number greater than
255, QFINDWIN will reject it, and select a default value.
NOTE - In a 16 color VGA system each primary color (RED,
GREEN, BLUE) only has 2 intensity values - Normal and
Bright. Any value over 128 will select the High Intensity
color and any value of 128 or less will select the normal
intensity of that color. In a 256 color system, the colors
will change with each smaller change in the values.
QFINDWIN.INI might contain the following:
[QFIND]
Color=YES
DirectoryColor=128,0,0
FileColor=128,0,128
ZipColor=0,128,0
The color entry selects the color option.
The DirectoryColor entry selects RED as the color for
Directory names.
The FileColor entry selects magenta as the color for File
names. Magenta is a color that uses a mix of RED and BLUE.
The ZipColor entry select GREEN as the color for zip files.
If the color entries are not defined in QFINDWIN.ZIP,
default colors will be selected.
A sample QFINDWIN.INI file is included in this release.
QFINDWIN uses the QFINDWIN.INI entry to find the data file
instead of the environment method. To tell QFINDWIN where
the data file is located, place the following 2 lines in the
QFINDWIN.INI file....
[qfind]
FILE = d:\temp OR wherever the data file is located.
Qfind Version 1.5 - Page 9
If there is no entry in the QFINDWIN.INI file, QFINDWIN will
look for the data file in the root directory of drive C.
Note........
THREE_D.DLL must be located in a directory that is defined
in your path for QFINDWIN to display in the 3D look. The
preferred location is in your Windows directory.
************************************************************
Support....
I can be reached on Compuserve. My ID is 70270,534
This is Version 1.5 of Qfind. I would appreciate feedback
on suggested additional features in the next version,
problems with this version, etc....
Qfind Version 1.5 - Page 10
Registration
Registering QFIND will get you the latest version of the
programs along with a utility that will personalize your
copy and remove the start-up message in QFINDWIN.
Disclaimer:
Users of QFIND, QFINDWIN, and QFBUILD must accept this
disclaimer of warranty: "QFIND, QFINDWIN, and QFBUILD are
supplied as is. The author disclaims all warranties,
expressed or implied, including, without limitation,the
warranties of merchantability and of fitness for any
purpose. The author assumes no liability for damages,
direct or consequential, which may result from the use of
these programs."
LICENSING AGREEMENT:
QFIND, QFINDWIN, AND QFBUILD are Copyright 1991, 1992 by
JebSoft and James E. Bell 135 Gunlock Trace, Roswell,
Georgia 30076
This program is made available through Shareware for
personal use on non-business PC's only. If you find these
programs useful and find that you are using them and
continue to use them after a reasonable trial period, you
must make a registration payment of $10.00 to James E. Bell.
Use of this program by any business, corporation, government
agency, or any other institution is prohibited without
payment of $10.00 to James E. Bell for each installed PC.
In accordance with the Shareware distribution method, all
users are granted a limited license to copy QFIND, QFINDWIN,
and QFBUILD for the trial use of others providing that there
programs are:
Copied in their original archive form.
Not modified in any way and are distributed with the
full and unmodified documentation.
Qfind Version 1.5 - Page 11
Are not sold or traded for money or any other
consideration by any party other than JebSoft and James
E. Bell
Not distributed in conjunction with any other product
or software without the written consent of James E.
Bell.
Qfind Version 1.5 - Page 12